/**
* Copyright 2023 PYSTOR DBS, Nanjing Pengyun Network Technology Co., Ltd.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*     http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/ 

package py.coordinator.calculator;

import java.util.List;
import py.common.struct.Pair;
import py.drivercontainer.exception.ProcessPositionException;
import py.exception.StorageException;


public interface LogicalToPhysicalCalculator {

  public void updateVolumeInformation() throws StorageException;

  public Pair<Integer, Long> convertLogicalPositionToPhysical(long position)
      throws ProcessPositionException,
      StorageException;

  public Pair<Integer, Long> convertLogicalPositionToPhysical(long position, long timeoutMs)
      throws ProcessPositionException, StorageException;

  public Pair<Integer, Long> convertPhysicalPositionToLogical(long position)
      throws ProcessPositionException,
      StorageException;

  public Pair<Integer, Long> convertPhysicalPositionToLogical(long position, long timeoutMs)
      throws ProcessPositionException, StorageException;

  public int calculateIndex(long position);

  public void setVolumeLayout(List<Long> volumeLayout);

  public long getPageSize();
}
